Skip to content

Document channel category sorting GA and default category behavior (v11.8)#9037

Merged
amyblais merged 4 commits into
v11.8-documentationfrom
claude/issue-9033-20260613-0119
Jun 16, 2026
Merged

Document channel category sorting GA and default category behavior (v11.8)#9037
amyblais merged 4 commits into
v11.8-documentationfrom
claude/issue-9033-20260613-0119

Conversation

@Combs7th

Copy link
Copy Markdown
Contributor

Documents that, from Mattermost v11.8.0, channel category sorting is enabled by default (TeamSettings.EnableChannelCategorySorting). Channel admins can set or clear a Default category (optional) when creating or editing a channel, and members who join see it under that sidebar category.

  • Adds the Channel category sorting setting under Site Configuration > Users and Teams.
  • Notes GA graduation on the legacy experimental settings entry.
  • Updates the end-user create-channels and rename-channels guides.

Per mattermost/mattermost#36289. Closes #9033

Generated with Claude Code

lieut-data and others added 2 commits June 12, 2026 12:04
…9029)

* Remove CJK search feature flag mention now that it defaults to true

* Clarify CJK search defaults to true on v11.9, flag-gated on v11.5-v11.8

* Potential fix for pull request finding

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
…11.8)

Documents that, from Mattermost v11.8.0, channel category sorting is
enabled by default (TeamSettings.EnableChannelCategorySorting). Channel
admins can set a Default category (optional) when creating or editing a
channel, and members who join see the channel under that sidebar category.

- Adds the Channel category sorting setting under Site Configuration >
  Users and Teams in site-configuration-settings.rst.
- Notes graduation to GA on the legacy experimental settings entry.
- Updates the end-user create-channels and rename-channels guides.

Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>
@github-actions

Copy link
Copy Markdown
Contributor

Newest code from mattermost has been published to preview environment for Git SHA ccdcdbe

@Combs7th Combs7th changed the base branch from master to v11.8-documentation June 13, 2026 01:33
@coderabbitai

coderabbitai Bot commented Jun 13, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

This PR updates Mattermost documentation to reflect channel category sorting moving from experimental to generally available in v11.8. The changes add a note to experimental settings, document the new non-experimental configuration option, and update end-user guidance for channel creation and renaming to reflect the feature's default-enabled status.

Changes

Channel Category Sorting v11.8 Documentation

Layer / File(s) Summary
Admin configuration documentation
source/administration-guide/configure/experimental-configuration-settings.rst, source/administration-guide/configure/site-configuration-settings.rst
Experimental settings note clarified that channel category sorting is now generally available and enabled by default as of v11.8, redirecting admins to the new System Console path. New "Channel category sorting" setting documented under Site Configuration > Users and Teams with configuration metadata, setting key (.TeamSettings.EnableChannelCategorySorting), environment variable, and a table describing enabled vs. disabled behaviour.
End-user channel management guidance
source/end-user-guide/collaborate/create-channels.rst, source/end-user-guide/collaborate/rename-channels.rst
Channel creation instructions updated to add an optional step for assigning the channel to a default category when the feature is enabled. Rename channel instructions updated to explain how admins can set an optional Default category for renamed channels, including the ability to select, create, or clear the category.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the main change: documenting channel category sorting GA (general availability) and its default-enabled behavior in Mattermost v11.8.
Description check ✅ Passed The description comprehensively explains the changeset: documenting channel category sorting as GA/default-on in v11.8, adding Site Configuration documentation, updating experimental settings notes, and revising end-user guides.
Linked Issues check ✅ Passed The changes align with linked issue #9033 requirements: documents admin-facing UI behavior (Site Configuration setting), extracts v11.8 version from PR metadata, covers default category behavior for channel creation and settings, updates existing docs, and avoids implementation details.
Out of Scope Changes check ✅ Passed All four file changes are directly scoped to the linked issue objectives: three files document admin and end-user-visible default category behavior, and one adds the Site Configuration setting entry, with no unrelated alterations.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch claude/issue-9033-20260613-0119

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@source/end-user-guide/collaborate/create-channels.rst`:
- Line 24: The linked fallback URL in create-channels.rst (and similarly in
rename-channels.rst) still points to the old `customize-your-channel-sidebar`
page which contains experimental-settings wording; update the link target or
surrounding text to point to the revised GA sidebar-category documentation (or
update the downstream `customize-your-channel-sidebar` page to match GA wording)
so the channel creation and rename flows are consistent with the v11.8
default-on channel category sorting messaging; locate the link in
create-channels.rst and rename-channels.rst and replace the
`customize-your-channel-sidebar` reference with the new GA sidebar-category doc
path or adjust the sentence to reference the updated guide.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 97fb9f76-d4f7-4dee-bdcb-74bf47ad625b

📥 Commits

Reviewing files that changed from the base of the PR and between ea7ca0d and ccdcdbe.

📒 Files selected for processing (4)
  • source/administration-guide/configure/experimental-configuration-settings.rst
  • source/administration-guide/configure/site-configuration-settings.rst
  • source/end-user-guide/collaborate/create-channels.rst
  • source/end-user-guide/collaborate/rename-channels.rst

Comment thread source/end-user-guide/collaborate/create-channels.rst
@Combs7th Combs7th added 1: Dev Review Requires review by a core commiter 2: Editor Review Requires review by an editor labels Jun 13, 2026
@Combs7th Combs7th added this to the v11.8.0 milestone Jun 13, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Newest code from mattermost has been published to preview environment for Git SHA eb046b8

Aligns the customize-your-channel-sidebar note with the v11.8 default-on
messaging by referencing the new Site Configuration setting instead of the
experimental settings anchor.

Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>
@github-actions

Copy link
Copy Markdown
Contributor

Newest code from mattermost has been published to preview environment for Git SHA 1ab7a1a

@Combs7th Combs7th requested review from devinbinnie and marianunez and removed request for devinbinnie June 13, 2026 01:54
@Combs7th

Copy link
Copy Markdown
Contributor Author

@marianunez - Can you help give this one a dev review for Devin since he's on PTO?

@Combs7th Combs7th requested a review from wiersgallak June 13, 2026 02:15
@Combs7th

Copy link
Copy Markdown
Contributor Author

@wiersgallak - This one will need editor review as well after dev review is complete.

@Combs7th Combs7th requested a review from amyblais June 15, 2026 08:07

@wiersgallak wiersgallak left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@Combs7th Combs7th removed the 2: Editor Review Requires review by an editor label Jun 15, 2026
@Combs7th

Copy link
Copy Markdown
Contributor Author

Just need a dev review from @marianunez on this one and it should be all set.

@Combs7th Combs7th added 3: Reviews Complete All reviewers have approved the pull request and removed 1: Dev Review Requires review by a core commiter labels Jun 15, 2026
@amyblais amyblais merged commit 7848385 into v11.8-documentation Jun 16, 2026
8 checks passed
@amyblais amyblais deleted the claude/issue-9033-20260613-0119 branch June 16, 2026 05:21
amyblais added a commit that referenced this pull request Jun 16, 2026
* Update conf.py

* MM-67771: Update Report a Problem default behavior docs (#8845)

* MM-67771: Update Report a Problem docs to reflect email flow

Update the "Default link" description to reflect the new behavior:
licensed servers now open an email to Mattermost support, and free
edition directs to the troubleshooting forums.

Also fix typo in REPORTAPROBLMEMAIL env var name.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Update site-configuration-settings.rst

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: Eric Sethna <14333569+esethna@users.noreply.github.com>
Co-authored-by: Amy Blais <29708087+amyblais@users.noreply.github.com>

* [MM-67856] docs: add /mobile-logs slash command (#8913)

* docs: add /mobile-logs slash command

Document the new /mobile-logs command introduced in mattermost/mattermost#35658,
which toggles the attach_app_logs preference to enable attaching mobile app
logs as a file in the Mattermost mobile client (v2.38+) for debugging.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* docs: refine /mobile-logs admonition and wording

- Elevate security/audit note to .. important::
- Use bold instead of italics for the error message
- Clarify the attachment applies to any message the user sends

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* address reviews

* docs: refine mobile troubleshooting formatting

* improve description

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Added docs for deletion summary feature (#8933)

* Added docs for deletion summary feature

* Review fixes

* Added docs (#8934)

* v11.8.0 Changelog (#8987)

* docs: add changelog for v11.8.0

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update source/product-overview/mattermost-v11-changelog.md

Co-authored-by: Jesse Hallam <jesse.hallam@gmail.com>

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Add attribute value masking information to 11.8.0 changelog docs (#8999)

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update source/product-overview/mattermost-v11-changelog.md

Co-authored-by: Maria A Nunez <maria.nunez@mattermost.com>

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

---------

Co-authored-by: Changelog Bot <changelog-bot@mattermost.com>
Co-authored-by: Amy Blais <29708087+amyblais@users.noreply.github.com>
Co-authored-by: Jesse Hallam <jesse.hallam@gmail.com>
Co-authored-by: Pablo Vélez <pablovv2012@gmail.com>
Co-authored-by: Maria A Nunez <maria.nunez@mattermost.com>

* v11.8 Upgrade Notes (#8983)

* Update docs for v11.8 (June 16th) release

- Add v11.8 row to server releases table (released 2026-06-16, support ends 2026-09-15)
- Bump latest release download URLs to 11.8.0 in deploy-rhel.rst and deploy-tar.rst
- Add v11.8 to compatibility list for Desktop App v6.2 (ESR)
- Update release policy gantt chart: mark v11.5 as done, add v11.9
- Add Mattermost Enterprise Edition v11.8.0 entry to open source components

Refs #8981

Co-authored-by: Amy Blais <amyblais@users.noreply.github.com>

* Update mattermost-desktop-releases.md

* Update open-source-components.rst

* Update ui-ada-changelog.rst

* Update important-upgrade-notes.rst

* Update important-upgrade-notes.rst

* Update important-upgrade-notes.rst

* Update important-upgrade-notes.rst

* Update important-upgrade-notes.rst

* Update important-upgrade-notes.rst

* Update source/product-overview/ui-ada-changelog.rst

Co-authored-by: Guillermo Vayá <guivaya@gmail.com>

* Update important-upgrade-notes.rst

* Update ui-ada-changelog.rst

---------

Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: Amy Blais <amyblais@users.noreply.github.com>
Co-authored-by: Guillermo Vayá <guivaya@gmail.com>

* Update version-archive.rst (#9026)

* Add Edit Attachments permission documentation (#9024)

* MM-68718: Document Azure Blob Storage as a file storage backend (#8976)

* Document Azure Blob Storage as a file storage backend

Adds Azure Blob Storage to the File storage system reference: a new
azureblob driver-name option and individual entries for the
FileSettings.AzureStorageAccount, AzureContainer, AzurePathPrefix,
AzureAccessKey, AzureEndpoint, AzureSSL, and
AzureRequestTimeoutMilliseconds settings. Extends the dedicated export
filestore list with the matching Export* variants.

Calls out the restart-required behaviour when changing file storage
settings so admins know Save in System Console isn't enough on its
own.

------
AI assisted commit

* Add walk-through page for configuring Azure Blob Storage

Folds the full prereqs, Azure portal/CLI provisioning, System Console
walk-through, Test Connection semantics, restart-required warning,
verification, optional export backend, and troubleshooting sections
into a dedicated configure/azure-blob-storage page.

Wires the new page into the configuration-settings toctree and bullet
list, and adds a seealso link from the File storage section of
environment-configuration-settings so admins can find it from the
reference page.

------
AI assisted commit

* Document migrating existing files from Amazon S3

Adds a Migrate existing files from Amazon S3 section to the Azure
Blob Storage walk-through. Covers the recommended trickle-then-cutover
pattern (long rclone sync, short AzCopy maintenance window), the
prerequisites for the migration host, phase-by-phase commands,
verification queries (object count parity, sha256 spot-check), the
rollback path, and caveats (S3 versioning, sync vs copy, prefix
rewrites, cross-region cost, Storage Mover preview status).

Updates the migration note under step 4 and the troubleshooting entry
for missing pre-cutover files to cross-reference the new section.

------
AI assisted commit

* Document AzureCloud and the updated AzureEndpoint semantics

Adds the AzureCloud setting documentation (commercial/government/custom)
to both the environment configuration reference and the Azure walkthrough,
rewrites the AzureEndpoint entry to reflect its new role as the full
Blob service URL valid only when AzureCloud is custom, and removes the
stale note that said sovereign clouds aren't configured through the
endpoint override. Adds ExportAzureCloud to the dedicated export
filestore key list.

------
AI assisted commit

* Document DefaultAzureCredential authentication mode

Restructures Step 3 of the Azure Blob Storage walk-through to cover
both shared-key and the new default_credential authentication mode.
The default_credential subsection walks an admin through picking the
identity source that matches the host (managed identity on Azure
VM/App Service/AKS, workload identity, service principal, az login)
and granting Storage Blob Data Contributor on the storage account.

Updates Step 4 to describe the new "Azure authentication" dropdown
in the System Console, including the conditional visibility of the
Azure Storage account key field. Adds AuthorizationPermissionMismatch
to the troubleshooting table and documents the propagation delay
that follows a fresh role assignment.

Adds FileSettings.AzureAuthMode to the environment-configuration
reference and to the ExportAzure* list under the dedicated export
filestore section.

------
AI assisted commit

* Simplify the docs

* Update source/administration-guide/configure/azure-blob-storage.rst

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* Document Azure SAS support for presigned export downloads

Add ExportAzurePresignExpiresSeconds to the dedicated export filestore
key list, and generalize the presigned-download note so it reflects that
exports can now be downloaded via an Azure Blob Storage SAS URL, not just
an Amazon S3 presigned URL.

------
AI assisted commit

* Address review comments

* Add missing new line

* Fix malformed quotes

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* docs: clarify ID attribute case sensitivity for AD/LDAP and SAML (#9020)

Add notes to the AD/LDAP ID attribute, AD/LDAP Group ID attribute, and
SAML ID attribute settings explaining that values are matched verbatim
with no case normalization. Under PostgreSQL's default case-sensitive
collation, a change in casing is treated as a new user or unlinked
group, so the identity provider must return these attributes with
consistent casing.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-authored-by: Katie Wiersgalla <39744472+wiersgallak@users.noreply.github.com>

* docs: add Edit Attachments permission documentation

Document the new Edit Attachments permission introduced in Mattermost
v11.8.0, which controls whether users can add or remove file attachments
when editing posts.

Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* Update authentication-configuration-settings.rst

* Update authentication-configuration-settings.rst

* Update authentication-configuration-settings.rst

* Update authentication-configuration-settings.rst

* Update azure-blob-storage.rst

* Update azure-blob-storage.rst

* Remove unintended configure file changes

---------

Co-authored-by: Alejandro García Montoro <alejandro.garciamontoro@gmail.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: Wayne Wollesen <50209602+ewwollesen@users.noreply.github.com>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-authored-by: Katie Wiersgalla <39744472+wiersgallak@users.noreply.github.com>
Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>

* Update mattermost-v11-changelog.md

* Document v11.8 classification markings and banners (#9035)

* Remove CJK search feature flag mention now that it defaults to true (#9029)

* Remove CJK search feature flag mention now that it defaults to true

* Clarify CJK search defaults to true on v11.9, flag-gated on v11.5-v11.8

* Potential fix for pull request finding

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* Document v11.8 classification markings and banners

Add an end-user Classification markings section to display-channel-banners.rst
and an admin Classification Markings section to site-configuration-settings.rst,
covering global and channel-level classification banners in the web and desktop
apps. Classification markings are informational only and don't control access.

Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

* Removing unintended commits

---------

Co-authored-by: Jesse Hallam <jesse.hallam@gmail.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

* Update mattermost-v11-changelog.md

* Document plugin-provided metrics at the standard /metrics endpoint (#9038)

* Remove CJK search feature flag mention now that it defaults to true (#9029)

* Remove CJK search feature flag mention now that it defaults to true

* Clarify CJK search defaults to true on v11.9, flag-gated on v11.5-v11.8

* Potential fix for pull request finding

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* Document plugin-provided metrics via standard /metrics endpoint

Add documentation for the AggregatePluginMetrics feature flag (v11.8.0),
which exposes plugin-provided Prometheus metrics through the standard
Mattermost /metrics endpoint with a plugin_id label.

Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

* Removing unintended commits

---------

Co-authored-by: Jesse Hallam <jesse.hallam@gmail.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

* Update docs for System Statistics label (#8915)

Align the docs with the admin console rename from Site Statistics to System Statistics so navigation and delegated-admin guidance match the UI. Preserve the legacy reporting settings anchor so existing deep links continue to resolve.

Made-with: Cursor

Co-authored-by: Amy Blais <29708087+amyblais@users.noreply.github.com>

* Update mattermost-v11-changelog.md

* Document User Attributes Display Name and Name (v11.8) (#9025)

* MM-68718: Document Azure Blob Storage as a file storage backend (#8976)

* Document Azure Blob Storage as a file storage backend

Adds Azure Blob Storage to the File storage system reference: a new
azureblob driver-name option and individual entries for the
FileSettings.AzureStorageAccount, AzureContainer, AzurePathPrefix,
AzureAccessKey, AzureEndpoint, AzureSSL, and
AzureRequestTimeoutMilliseconds settings. Extends the dedicated export
filestore list with the matching Export* variants.

Calls out the restart-required behaviour when changing file storage
settings so admins know Save in System Console isn't enough on its
own.

------
AI assisted commit

* Add walk-through page for configuring Azure Blob Storage

Folds the full prereqs, Azure portal/CLI provisioning, System Console
walk-through, Test Connection semantics, restart-required warning,
verification, optional export backend, and troubleshooting sections
into a dedicated configure/azure-blob-storage page.

Wires the new page into the configuration-settings toctree and bullet
list, and adds a seealso link from the File storage section of
environment-configuration-settings so admins can find it from the
reference page.

------
AI assisted commit

* Document migrating existing files from Amazon S3

Adds a Migrate existing files from Amazon S3 section to the Azure
Blob Storage walk-through. Covers the recommended trickle-then-cutover
pattern (long rclone sync, short AzCopy maintenance window), the
prerequisites for the migration host, phase-by-phase commands,
verification queries (object count parity, sha256 spot-check), the
rollback path, and caveats (S3 versioning, sync vs copy, prefix
rewrites, cross-region cost, Storage Mover preview status).

Updates the migration note under step 4 and the troubleshooting entry
for missing pre-cutover files to cross-reference the new section.

------
AI assisted commit

* Document AzureCloud and the updated AzureEndpoint semantics

Adds the AzureCloud setting documentation (commercial/government/custom)
to both the environment configuration reference and the Azure walkthrough,
rewrites the AzureEndpoint entry to reflect its new role as the full
Blob service URL valid only when AzureCloud is custom, and removes the
stale note that said sovereign clouds aren't configured through the
endpoint override. Adds ExportAzureCloud to the dedicated export
filestore key list.

------
AI assisted commit

* Document DefaultAzureCredential authentication mode

Restructures Step 3 of the Azure Blob Storage walk-through to cover
both shared-key and the new default_credential authentication mode.
The default_credential subsection walks an admin through picking the
identity source that matches the host (managed identity on Azure
VM/App Service/AKS, workload identity, service principal, az login)
and granting Storage Blob Data Contributor on the storage account.

Updates Step 4 to describe the new "Azure authentication" dropdown
in the System Console, including the conditional visibility of the
Azure Storage account key field. Adds AuthorizationPermissionMismatch
to the troubleshooting table and documents the propagation delay
that follows a fresh role assignment.

Adds FileSettings.AzureAuthMode to the environment-configuration
reference and to the ExportAzure* list under the dedicated export
filestore section.

------
AI assisted commit

* Simplify the docs

* Update source/administration-guide/configure/azure-blob-storage.rst

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* Document Azure SAS support for presigned export downloads

Add ExportAzurePresignExpiresSeconds to the dedicated export filestore
key list, and generalize the presigned-download note so it reflects that
exports can now be downloaded via an Azure Blob Storage SAS URL, not just
an Amazon S3 presigned URL.

------
AI assisted commit

* Address review comments

* Add missing new line

* Fix malformed quotes

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* docs: clarify ID attribute case sensitivity for AD/LDAP and SAML (#9020)

Add notes to the AD/LDAP ID attribute, AD/LDAP Group ID attribute, and
SAML ID attribute settings explaining that values are matched verbatim
with no case normalization. Under PostgreSQL's default case-sensitive
collation, a change in casing is treated as a new user or unlinked
group, so the identity provider must return these attributes with
consistent casing.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-authored-by: Katie Wiersgalla <39744472+wiersgallak@users.noreply.github.com>

* docs: document User Attributes Display Name and Name (v11.8)

Explain that from Mattermost v11.8 user attributes have both a
Display Name (user/admin-facing label) and a Name (internal canonical
identifier used in ABAC policy expressions and API references).

Refs mattermost/mattermost#36247, mattermost/mattermost#36363

Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

* Remove unintended configure changes

* Update source/administration-guide/manage/admin/user-attributes.rst

Co-authored-by: Maria A Nunez <maria.nunez@mattermost.com>

* Update user-attributes.rst

* Update user-attributes.rst

* Update source/administration-guide/manage/admin/user-attributes.rst

Co-authored-by: Maria A Nunez <maria.nunez@mattermost.com>

* Update source/administration-guide/manage/admin/user-attributes.rst

Co-authored-by: Maria A Nunez <maria.nunez@mattermost.com>

* Update user-attributes.rst

---------

Co-authored-by: Alejandro García Montoro <alejandro.garciamontoro@gmail.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: Wayne Wollesen <50209602+ewwollesen@users.noreply.github.com>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-authored-by: Katie Wiersgalla <39744472+wiersgallak@users.noreply.github.com>
Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>
Co-authored-by: Maria A Nunez <maria.nunez@mattermost.com>

* Document channel category sorting GA and default category behavior (v11.8) (#9037)

* Remove CJK search feature flag mention now that it defaults to true (#9029)

* Remove CJK search feature flag mention now that it defaults to true

* Clarify CJK search defaults to true on v11.9, flag-gated on v11.5-v11.8

* Potential fix for pull request finding

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* Document channel category sorting GA and default category behavior (v11.8)

Documents that, from Mattermost v11.8.0, channel category sorting is
enabled by default (TeamSettings.EnableChannelCategorySorting). Channel
admins can set a Default category (optional) when creating or editing a
channel, and members who join see the channel under that sidebar category.

- Adds the Channel category sorting setting under Site Configuration >
  Users and Teams in site-configuration-settings.rst.
- Notes graduation to GA on the legacy experimental settings entry.
- Updates the end-user create-channels and rename-channels guides.

Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

* Removing unintended commits

* Update sidebar guide to GA wording for channel category sorting

Aligns the customize-your-channel-sidebar note with the v11.8 default-on
messaging by referencing the new Site Configuration setting instead of the
experimental settings anchor.

Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

---------

Co-authored-by: Jesse Hallam <jesse.hallam@gmail.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

* Update mattermost-v11-changelog.md

* Update ui-ada-changelog.rst

---------

Co-authored-by: Vishal <vish@mattermost.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: Eric Sethna <14333569+esethna@users.noreply.github.com>
Co-authored-by: Guillermo Vayá <guivaya@gmail.com>
Co-authored-by: Harshil Sharma <18575143+harshilsharma63@users.noreply.github.com>
Co-authored-by: changelog-automation-docs[bot] <278388344+changelog-automation-docs[bot]@users.noreply.github.com>
Co-authored-by: Changelog Bot <changelog-bot@mattermost.com>
Co-authored-by: Jesse Hallam <jesse.hallam@gmail.com>
Co-authored-by: Pablo Vélez <pablovv2012@gmail.com>
Co-authored-by: Maria A Nunez <maria.nunez@mattermost.com>
Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: Amy Blais <amyblais@users.noreply.github.com>
Co-authored-by: Combs7th <147677911+Combs7th@users.noreply.github.com>
Co-authored-by: Alejandro García Montoro <alejandro.garciamontoro@gmail.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: Wayne Wollesen <50209602+ewwollesen@users.noreply.github.com>
Co-authored-by: Katie Wiersgalla <39744472+wiersgallak@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

3: Reviews Complete All reviewers have approved the pull request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document default channel category name / managed categories

5 participants